<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html><head>

  
  <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"><title>Rest Api</title>
  

  
  
  <meta name="id" content="64e3dc97-5125-541e-9e84-7f9303e95f03">

  
  <meta name="revisionNumber" content="1"></head><body>
<div style="border: 3pt solid rgb(219, 229, 241); padding: 0in; background: rgb(219, 229, 241) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">
<h2><a name="_Toc235247788">Rest API<br>
</a></h2>
</div>

<p style="font-family: Helvetica,Arial,sans-serif;" class="MsoNormal">The Rest API is the set of Web Services that Facebook provides
for retrieving data from and sending data to the Facebook platform. <span style="">&nbsp;</span>As described elsewhere in this documentation,
this API is really only part of the power of the Facebook Platform.<span style="">&nbsp; </span>The <a href="http://wiki.developers.facebook.com/index.php/API">Developer Wiki</a> is
the best source of up to date information on the REST api.</p>


<p style="font-family: Helvetica,Arial,sans-serif;" class="MsoNormal"><span style="" lang="EN">The API uses a <a href="http://en.wikipedia.org/wiki/Representational_State_Transfer" title="wikipedia:Representational_State_Transfer"><span style="font-size: 12.5pt; line-height: 115%; color: rgb(51, 102, 187);">REST</span></a>-like
interface. This means that our Facebook method calls are made over the internet
by sending HTTP GET or POST requests to the <a href="http://api.facebook.com/restserver.php" title="http://api.facebook.com/restserver.php"><span style="font-size: 12.5pt; line-height: 115%; color: rgb(51, 102, 187);">Facebook API
REST server</span></a> . Nearly any computer language can be used to
communicate over HTTP with the REST server. </span><span style=""><br>
</span></p>
<p style="font-family: Helvetica,Arial,sans-serif;" class="MsoNormal"><span style=""></span>One
of the core features of the Facebook Developer Toolkit is that it simplifies
communication with the REST Api and provides strongly typed .NET objects that
represent ALL the data that is returned from the various REST calls.<span style="">&nbsp; </span>The toolkit provides all the plumbing to
compose the parameters using the mechanism that Facebook expects and also to
parse the returned data and provide it with easy to use entity objects that are
generated from Facebook&#8217;s schema.<br>
</p>
<span style="font-size: 10pt; line-height: 115%; font-family: Helvetica,Arial,sans-serif;"></span><a style="font-family: Helvetica,Arial,sans-serif;" name="API_Methods"></a>
<div style="border: 3pt solid rgb(219, 229, 241); padding: 0in; background: rgb(219, 229, 241) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;">
<h2><a name="_Toc235247788">Available API Methods<br>
</a></h2>
</div>

<h3 id="siteSub">From Facebook Developer Wiki (as of 7/14/2009)<br>
</h3>

<dl style="font-family: Helvetica,Arial,sans-serif;">

  <dt><br>
  </dt>
  <dt><a title="Admin.getAllocation" href="http://wiki.developers.facebook.com/index.php/Admin.getAllocation">admin.getAllocation</a> </dt>
  <dd>Returns the current allocation limit for your application for the
specified integration point. </dd>
  <dt><a title="Admin.getAppProperties" href="http://wiki.developers.facebook.com/index.php/Admin.getAppProperties">admin.getAppProperties</a> </dt>
  <dd>Returns values of properties for your applications from the
Facebook Developer application. </dd>
  <dt><a title="Admin.getMetrics" href="http://wiki.developers.facebook.com/index.php/Admin.getMetrics">admin.getMetrics</a>
  </dt>
  <dd>Returns specified metrics for your application, given a time
period. </dd>
  <dt><a title="Admin.getRestrictionInfo" href="http://wiki.developers.facebook.com/index.php/Admin.getRestrictionInfo">admin.getRestrictionInfo</a>
  </dt>
  <dd>Returns the <a title="Demographic Restrictions" href="http://wiki.developers.facebook.com/index.php/Demographic_Restrictions">demographic restrictions</a>
for the application. </dd>
  <dt><a title="Admin.setAppProperties" href="http://wiki.developers.facebook.com/index.php/Admin.setAppProperties">admin.setAppProperties</a> </dt>
  <dd>Sets values for properties for your applications in the Facebook
Developer application. </dd>
  <dt><a title="Admin.setRestrictionInfo" href="http://wiki.developers.facebook.com/index.php/Admin.setRestrictionInfo">admin.setRestrictionInfo</a>
  </dt>
  <dd>Sets the <a title="Demographic Restrictions" href="http://wiki.developers.facebook.com/index.php/Demographic_Restrictions">demographic restrictions</a>
for the application. </dd>
  <dt><a title="Admin.banUsers" href="http://wiki.developers.facebook.com/index.php/Admin.banUsers">admin.banUsers</a>
  </dt>
  <dd>Prevents users from accessing an application's canvas page and
its forums. </dd>
  <dt><a title="Admin.unbanUsers" href="http://wiki.developers.facebook.com/index.php/Admin.unbanUsers">admin.unbanUsers</a>
  </dt>
  <dd>Unbans users previously banned with admin.banUsers. </dd>
  <dt><a title="Admin.getBannedUsers" href="http://wiki.developers.facebook.com/index.php/Admin.getBannedUsers">admin.getBannedUsers</a> </dt>
  <dd>Returns the list of users who have been banned from the
application. </dd>
  <dt><a title="Application.getPublicInfo" href="http://wiki.developers.facebook.com/index.php/Application.getPublicInfo">application.getPublicInfo</a>
  </dt>
  <dd>Returns public information about a given application (not
necessarily your own). </dd>
  <dt><a title="Auth.createToken" href="http://wiki.developers.facebook.com/index.php/Auth.createToken">auth.createToken</a>
  </dt>
  <dd>Creates an <code>auth_token</code> to be passed in as a
parameter to login.php and then to auth.getSession after the user has
logged in. </dd>
  <dt><a title="Auth.expireSession" href="http://wiki.developers.facebook.com/index.php/Auth.expireSession">auth.expireSession</a>
  </dt>
  <dd>Expires the session indicated in the API call, for your
application. </dd>
  <dt><a title="Auth.getSession" href="http://wiki.developers.facebook.com/index.php/Auth.getSession">auth.getSession</a>
  </dt>
  <dd>Returns the session key bound to an auth_token, as returned by <a title="Auth.createToken" href="http://wiki.developers.facebook.com/index.php/Auth.createToken">auth.createToken</a>
or in the callback URL. </dd>
  <dt><a title="Auth.promoteSession" href="http://wiki.developers.facebook.com/index.php/Auth.promoteSession">auth.promoteSession</a> </dt>
  <dd>Returns a temporary session secret associated to the current
existing session, for use in a client-side component to an application.
  </dd>
  <dt><a title="Auth.revokeAuthorization" href="http://wiki.developers.facebook.com/index.php/Auth.revokeAuthorization">auth.revokeAuthorization</a>
  </dt>
  <dd>If this method is called for the logged in user, then no further
API calls can be made on that user's behalf until the user decides to
authorize the application again. </dd>
  <dt><a title="Auth.revokeExtendedPermission" href="http://wiki.developers.facebook.com/index.php/Auth.revokeExtendedPermission">auth.revokeExtendedPermission</a>
  </dt>
  <dd>Removes a specific <a title="Extended permission" href="http://wiki.developers.facebook.com/index.php/Extended_permission">extended permission</a> that a
user explicitly granted to your application. </dd>
  <dt><a title="Batch.run" href="http://wiki.developers.facebook.com/index.php/Batch.run">batch.run</a> </dt>
  <dd>Execute a list of individual API calls in a single batch. </dd>
  <dt><a title="Comments.add" href="http://wiki.developers.facebook.com/index.php/Comments.add">comments.add</a>
    <font color="red">(BETA)</font> </dt>
  <dd>Adds a comment for a given <code>xid</code> on behalf of a user.
Calls with a session secret may only act on behalf of the session user.
  </dd>
  <dt><a title="Comments.get" href="http://wiki.developers.facebook.com/index.php/Comments.get">comments.get</a>
  </dt>
  <dd>Returns all comments for a given <code>xid</code> posted through
    <a title="Fb:comments" href="http://wiki.developers.facebook.com/index.php/Fb:comments">fb:comments</a>.
This method is a wrapper for the FQL query on the <a title="Comment (FQL)" href="http://wiki.developers.facebook.com/index.php/Comment_%28FQL%29">comment</a>
FQL table. </dd>
  <dt><a title="Comments.remove" href="http://wiki.developers.facebook.com/index.php/Comments.remove">comments.remove</a>
    <font color="red">(BETA)</font> </dt>
  <dd>Removes a comment for a given <code>xid</code> by comment_id.
Calls with a session secret may only act on behalf of the session user.
  </dd>
  <dt><a title="Connect.getUnconnectedFriendsCount" href="http://wiki.developers.facebook.com/index.php/Connect.getUnconnectedFriendsCount">connect.getUnconnectedFriendsCount</a>
  </dt>
  <dd>Returns the number of friends of the current user who have
accounts on your site, but have not yet connected their accounts. (for
[{Facebook Connect]]). </dd>
  <dt><a title="Connect.registerUsers" href="http://wiki.developers.facebook.com/index.php/Connect.registerUsers">connect.registerUsers</a> </dt>
  <dd>Creates an association between an existing user account on your
site and that user's Facebook account, provided the user has not
connected accounts before (for <a title="Facebook Connect" href="http://wiki.developers.facebook.com/index.php/Facebook_Connect">Facebook Connect</a>). </dd>
  <dt><a title="Connect.unregisterUsers" href="http://wiki.developers.facebook.com/index.php/Connect.unregisterUsers">connect.unregisterUsers</a> </dt>
  <dd>Unregisters a previously registered account (using <a title="Connect.registerUsers" href="http://wiki.developers.facebook.com/index.php/Connect.registerUsers">connect.registerUsers</a>).
You should call this method if the user deletes his or her account on
your site. (for <a title="Facebook Connect" href="http://wiki.developers.facebook.com/index.php/Facebook_Connect">Facebook Connect</a>). </dd>
  <dt><a title="Data.getCookies" href="http://wiki.developers.facebook.com/index.php/Data.getCookies">data.getCookies</a>
    <font color="red">(BETA)</font> </dt>
  <dd>Returns all cookies for a given user and application. </dd>
  <dt><a title="Data.setCookie" href="http://wiki.developers.facebook.com/index.php/Data.setCookie">data.setCookie</a>
    <font color="red">(BETA)</font> </dt>
  <dd>Sets a cookie for a given user and application. </dd>
  <dt><a title="Events.cancel" href="http://wiki.developers.facebook.com/index.php/Events.cancel">events.cancel</a>
  </dt>
  <dd>Cancels an event. The application must be an admin of the event. </dd>
  <dt><a title="Events.create" href="http://wiki.developers.facebook.com/index.php/Events.create">events.create</a>
  </dt>
  <dd>Creates an event on behalf of the user if the application has an
active session; otherwise it creates an event on behalf of the
application. </dd>
  <dt><a title="Events.edit" href="http://wiki.developers.facebook.com/index.php/Events.edit">events.edit</a>
  </dt>
  <dd>Edits an existing event. The application must be an admin of the
event. </dd>
  <dt><a title="Events.get" href="http://wiki.developers.facebook.com/index.php/Events.get">events.get</a>
  </dt>
  <dd>Returns all visible events according to the filters specified. </dd>
  <dt><a title="Events.getMembers" href="http://wiki.developers.facebook.com/index.php/Events.getMembers">events.getMembers</a>
  </dt>
  <dd>Returns membership list data associated with an event. </dd>
  <dt><a title="Events.rsvp" href="http://wiki.developers.facebook.com/index.php/Events.rsvp">events.rsvp</a>
  </dt>
  <dd>Sets the attendance option for the current user. </dd>
  <dt><a title="Fbml.deleteCustomTags" href="http://wiki.developers.facebook.com/index.php/Fbml.deleteCustomTags">fbml.deleteCustomTags</a> </dt>
  <dd>Deletes one or more <a title="Custom Tags" href="http://wiki.developers.facebook.com/index.php/Custom_Tags">custom tags</a> you previously
registered for the calling application with <a title="Fbml.registerCustomTags" href="http://wiki.developers.facebook.com/index.php/Fbml.registerCustomTags">fbml.registerCustomTags</a>.
  </dd>
  <dt><a title="Fbml.getCustomTags" href="http://wiki.developers.facebook.com/index.php/Fbml.getCustomTags">fbml.getCustomTags</a>
  </dt>
  <dd>Returns the <a title="Custom Tags" href="http://wiki.developers.facebook.com/index.php/Custom_Tags">custom
tag</a> definitions for tags that were previously defined using <a title="Fbml.registerCustomTags" href="http://wiki.developers.facebook.com/index.php/Fbml.registerCustomTags">fbml.registerCustomTags</a>.
  </dd>
  <dt><a title="Fbml.refreshImgSrc" href="http://wiki.developers.facebook.com/index.php/Fbml.refreshImgSrc">fbml.refreshImgSrc</a>
  </dt>
  <dd>Fetches and re-caches the image stored at the given URL. </dd>
  <dt><a title="Fbml.refreshRefUrl" href="http://wiki.developers.facebook.com/index.php/Fbml.refreshRefUrl">fbml.refreshRefUrl</a>
  </dt>
  <dd>Fetches and re-caches the content stored at the given URL. </dd>
  <dt><a title="Fbml.registerCustomTags" href="http://wiki.developers.facebook.com/index.php/Fbml.registerCustomTags">fbml.registerCustomTags</a> </dt>
  <dd>Registers <a title="Custom Tags" href="http://wiki.developers.facebook.com/index.php/Custom_Tags">custom
tags</a> you can include in your that applications' FBML markup. Custom
tags consist of FBML snippets that are rendered during parse time on
the containing page that references the custom tag. </dd>
  <dt><a title="Fbml.setRefHandle" href="http://wiki.developers.facebook.com/index.php/Fbml.setRefHandle">fbml.setRefHandle</a>
  </dt>
  <dd>Associates a given "handle" with FBML markup so that the handle
can be used within the <a title="Fb:ref" href="http://wiki.developers.facebook.com/index.php/Fb:ref">fb:ref</a>
FBML tag. </dd>
  <dt><a title="Fbml.uploadNativeStrings" href="http://wiki.developers.facebook.com/index.php/Fbml.uploadNativeStrings">fbml.uploadNativeStrings</a>
  </dt>
  <dd>Lets you insert text strings into the Facebook Translations
database so they can be translated. </dd>
  <dt><a title="Feed.deactivateTemplateBundleByID" href="http://wiki.developers.facebook.com/index.php/Feed.deactivateTemplateBundleByID">feed.deactivateTemplateBundleByID</a>
  </dt>
  <dd>Deactivates a previously registered template bundle. </dd>
  <dt><a title="Feed.getRegisteredTemplateBundleByID" href="http://wiki.developers.facebook.com/index.php/Feed.getRegisteredTemplateBundleByID">feed.getRegisteredTemplateBundleByID</a>
  </dt>
  <dd>Retrieves information about a specified template bundle
previously registered by the requesting application. </dd>
  <dt><a title="Feed.getRegisteredTemplateBundles" href="http://wiki.developers.facebook.com/index.php/Feed.getRegisteredTemplateBundles">feed.getRegisteredTemplateBundles</a>
  </dt>
  <dd>Retrieves the full list of all the template bundles registered by
the requesting application. </dd>
  <dt><a title="Feed.publishTemplatizedAction" href="http://wiki.developers.facebook.com/index.php/Feed.publishTemplatizedAction">feed.publishTemplatizedAction</a>
  </dt>
  <dd>Publishes a Mini-Feed story to the Facebook Page corresponding to
the <code>page_actor_id</code> parameter. </dd>
  <dd><b>Note:</b> This method is deprecated for actions taken by users
    <b>only</b>; it still works for actions taken by Facebook Pages. </dd>
  <dt><a title="Feed.publishUserAction" href="http://wiki.developers.facebook.com/index.php/Feed.publishUserAction">feed.publishUserAction</a> </dt>
  <dd>Publishes a story on behalf of the user owning the session, using
the specified template bundle. </dd>
  <dt><a title="Feed.registerTemplateBundle" href="http://wiki.developers.facebook.com/index.php/Feed.registerTemplateBundle">feed.registerTemplateBundle</a>
  </dt>
  <dd>Builds a template bundle around the specified templates,
registers them on Facebook, and responds with a template bundle ID that
can be used to identify your template bundle to other Feed-related API
calls. </dd>
  <dt><a title="Fql.query" href="http://wiki.developers.facebook.com/index.php/Fql.query">fql.query</a> </dt>
  <dd>Evaluates an FQL (Facebook Query Language) query. </dd>
  <dt><a title="Fql.multiquery" href="http://wiki.developers.facebook.com/index.php/Fql.multiquery">fql.multiquery</a>
  </dt>
  <dd>Evaluates a series of FQL (Facebook Query Language) queries in
one call and returns the data at one time. </dd>
  <dt><a title="Friends.areFriends" href="http://wiki.developers.facebook.com/index.php/Friends.areFriends">friends.areFriends</a>
  </dt>
  <dd>Returns whether or not each pair of specified users is friends
with each other. </dd>
  <dt><a title="Friends.get" href="http://wiki.developers.facebook.com/index.php/Friends.get">friends.get</a>
  </dt>
  <dd>Returns the identifiers for the current user's Facebook friends. </dd>
  <dt><a title="Friends.getAppUsers" href="http://wiki.developers.facebook.com/index.php/Friends.getAppUsers">friends.getAppUsers</a> </dt>
  <dd>Returns the identifiers for the current user's Facebook friends
who have authorized the specific calling application. </dd>
  <dt><a title="Friends.getLists" href="http://wiki.developers.facebook.com/index.php/Friends.getLists">friends.getLists</a>
  </dt>
  <dd>Returns the identifiers for the current user's Facebook friend
lists. </dd>
  <dt><a title="Friends.getMutualFriends" href="http://wiki.developers.facebook.com/index.php/Friends.getMutualFriends">friends.getMutualFriends</a>
  </dt>
  <dd>Returns the identifiers for the requested users' Mutual Facebook
friends. </dd>
  <dt><a title="Groups.get" href="http://wiki.developers.facebook.com/index.php/Groups.get">groups.get</a>
  </dt>
  <dd>Returns all visible groups according to the filters specified. </dd>
  <dt><a title="Groups.getMembers" href="http://wiki.developers.facebook.com/index.php/Groups.getMembers">groups.getMembers</a>
  </dt>
  <dd>Returns membership list data associated with a group. </dd>
  <dt><a title="Intl.getTranslations" href="http://wiki.developers.facebook.com/index.php/Intl.getTranslations">intl.getTranslations</a> <font color="red">(BETA)</font> </dt>
  <dd>Returns an array of strings from your application that you
submitted for translation. This call returns the original native
strings, the best (or all) translations of native strings into a given
locale, whether the string has been approved, and by whom. </dd>
  <dt><a title="Links.get" href="http://wiki.developers.facebook.com/index.php/Links.get">links.get</a> <font color="red">(BETA)</font> </dt>
  <dd>Returns all links the user has posted on their profile through
your application. </dd>
  <dt><a title="Links.post" href="http://wiki.developers.facebook.com/index.php/Links.post">links.post</a>
    <font color="red">(BETA)</font> </dt>
  <dd>Lets a user post a link on their Wall through your application. </dd>
  <dt><a title="LiveMessage.send" href="http://wiki.developers.facebook.com/index.php/LiveMessage.send">liveMessage.send</a>
    <font color="red">(BETA)</font> </dt>
  <dd>Sends a "message" directly to a user's browser, which can be
handled in <a title="FBJS" href="http://wiki.developers.facebook.com/index.php/FBJS">FBJS</a>. </dd>
  <dt><a title="Notes.create" href="http://wiki.developers.facebook.com/index.php/Notes.create">notes.create</a>
    <font color="red">(BETA)</font> </dt>
  <dd>Lets a user write a Facebook note through your application. </dd>
  <dt><a title="Notes.delete" href="http://wiki.developers.facebook.com/index.php/Notes.delete">notes.delete</a>
    <font color="red">(BETA)</font> </dt>
  <dd>Lets a user delete a Facebook note that was written through your
application. </dd>
  <dt><a title="Notes.edit" href="http://wiki.developers.facebook.com/index.php/Notes.edit">notes.edit</a>
    <font color="red">(BETA)</font> </dt>
  <dd>Lets a user edit a Facebook note through your application. </dd>
  <dt><a title="Notes.get" href="http://wiki.developers.facebook.com/index.php/Notes.get">notes.get</a> <font color="red">(BETA)</font> </dt>
  <dd>Returns a list of all of the visible notes written by the
specified user. </dd>
  <dt><a title="Notifications.get" href="http://wiki.developers.facebook.com/index.php/Notifications.get">notifications.get</a>
  </dt>
  <dd>Returns information on outstanding Facebook notifications for
current session user. </dd>
  <dt><a title="Notifications.send" href="http://wiki.developers.facebook.com/index.php/Notifications.send">notifications.send</a>
  </dt>
  <dd>Sends a notification to a set of users. </dd>
  <dt><a title="Notifications.sendEmail" href="http://wiki.developers.facebook.com/index.php/Notifications.sendEmail">notifications.sendEmail</a> </dt>
  <dd>Sends an email to the specified users who have the application. </dd>
  <dt><a title="Pages.getInfo" href="http://wiki.developers.facebook.com/index.php/Pages.getInfo">pages.getInfo</a>
  </dt>
  <dd>Returns all visible pages to the filters specified. </dd>
  <dt><a title="Pages.isAdmin" href="http://wiki.developers.facebook.com/index.php/Pages.isAdmin">pages.isAdmin</a>
  </dt>
  <dd>Checks whether the logged-in user is the admin for a given Page. </dd>
  <dt><a title="Pages.isAppAdded" href="http://wiki.developers.facebook.com/index.php/Pages.isAppAdded">pages.isAppAdded</a>
  </dt>
  <dd>Checks whether the Page has added the application. </dd>
  <dt><a title="Pages.isFan" href="http://wiki.developers.facebook.com/index.php/Pages.isFan">pages.isFan</a>
  </dt>
  <dd>Checks whether a user is a fan of a given Page. </dd>
  <dt><a title="Photos.addTag" href="http://wiki.developers.facebook.com/index.php/Photos.addTag">photos.addTag</a>
  </dt>
  <dd>Adds a tag with the given information to a photo. </dd>
  <dt><a title="Photos.createAlbum" href="http://wiki.developers.facebook.com/index.php/Photos.createAlbum">photos.createAlbum</a>
  </dt>
  <dd>Creates and returns a new album owned by the current session
user. </dd>
  <dt><a title="Photos.get" href="http://wiki.developers.facebook.com/index.php/Photos.get">photos.get</a>
  </dt>
  <dd>Returns all visible photos according to the filters specified. </dd>
  <dt><a title="Photos.getAlbums" href="http://wiki.developers.facebook.com/index.php/Photos.getAlbums">photos.getAlbums</a>
  </dt>
  <dd>Returns metadata about all of the photo albums uploaded by the
specified user. </dd>
  <dt><a title="Photos.getTags" href="http://wiki.developers.facebook.com/index.php/Photos.getTags">photos.getTags</a>
  </dt>
  <dd>Returns the set of user tags on all photos specified. </dd>
  <dt><a title="Photos.upload" href="http://wiki.developers.facebook.com/index.php/Photos.upload">photos.upload</a>
  </dt>
  <dd>Uploads a photo owned by the current session user and returns the
new photo. </dd>
  <dt><a title="Profile.getFBML" href="http://wiki.developers.facebook.com/index.php/Profile.getFBML">profile.getFBML</a>
  </dt>
  <dd>Gets the FBML that is currently set for a user's profile. </dd>
  <dt><a title="Profile.getInfo" href="http://wiki.developers.facebook.com/index.php/Profile.getInfo">profile.getInfo</a>
  </dt>
  <dd>Returns the specified user's application info section for the
calling application. </dd>
  <dt><a title="Profile.getInfoOptions" href="http://wiki.developers.facebook.com/index.php/Profile.getInfoOptions">profile.getInfoOptions</a> </dt>
  <dd>Returns the options associated with the specified field for an
application info section. </dd>
  <dt><a title="Profile.setFBML" href="http://wiki.developers.facebook.com/index.php/Profile.setFBML">profile.setFBML</a>
  </dt>
  <dd>Sets the FBML for a user's profile, including the content for
both the profile box and the profile actions. </dd>
  <dt><a title="Profile.setInfo" href="http://wiki.developers.facebook.com/index.php/Profile.setInfo">profile.setInfo</a>
  </dt>
  <dd>Configures an application info section that the specified user
can install on the Info tab of her profile. </dd>
  <dt><a title="Profile.setInfoOptions" href="http://wiki.developers.facebook.com/index.php/Profile.setInfoOptions">profile.setInfoOptions</a> </dt>
  <dd>Specifies the objects for a field for an application info
section. </dd>
  <dt><a title="Status.get" href="http://wiki.developers.facebook.com/index.php/Status.get">status.get</a>
    <font color="red">(BETA)</font> </dt>
  <dd>Returns the user's current and most recent statuses. </dd>
  <dt><a title="Status.set" href="http://wiki.developers.facebook.com/index.php/Status.set">status.set</a>
    <font color="red">(BETA)</font> </dt>
  <dd>Updates a user's Facebook status through your application. This
is a streamlined version of <a title="Users.setStatus" href="http://wiki.developers.facebook.com/index.php/Users.setStatus">users.setStatus</a>. </dd>
  <dt><a title="Stream.addComment" href="http://wiki.developers.facebook.com/index.php/Stream.addComment">stream.addComment</a>
    <font color="red">(BETA)</font> </dt>
  <dd>This method adds a comment to a post that was already published
to a user's Wall. </dd>
  <dt><a title="Stream.addLike" href="http://wiki.developers.facebook.com/index.php/Stream.addLike">stream.addLike</a>
    <font color="red">(BETA)</font> </dt>
  <dd>This method lets a user add a like to any post the user can see.
A user can like each post only once. </dd>
  <dt><a title="Stream.get" href="http://wiki.developers.facebook.com/index.php/Stream.get">stream.get</a>
    <font color="red">(BETA)</font> </dt>
  <dd>This method returns an object (in JSON-encoded or XML format)
that contains the stream from the perspective of a specific viewer -- a
user or a Facebook Page. </dd>
  <dt><a title="Stream.getComments" href="http://wiki.developers.facebook.com/index.php/Stream.getComments">stream.getComments</a>
    <font color="red">(BETA)</font> </dt>
  <dd>This method returns all comments associated with a post in a
user's stream. This method returns comments only if the user who owns
the post (that is, the user published the post to his or her profile)
has <a title="Authorizing Applications" href="http://wiki.developers.facebook.com/index.php/Authorizing_Applications">authorized</a> your
application. </dd>
  <dt><a title="Stream.getFilters" href="http://wiki.developers.facebook.com/index.php/Stream.getFilters">stream.getFilters</a>
    <font color="red">(BETA)</font> </dt>
  <dd>This method returns any filters a user has specified for his or
her home page stream. </dd>
  <dt><a title="Stream.publish" href="http://wiki.developers.facebook.com/index.php/Stream.publish">stream.publish</a>
    <font color="red">(BETA)</font> </dt>
  <dd>This method publishes a post into the stream on the user's Wall
and News Feed. This post also appears in the user's friends' streams
(their News Feeds). </dd>
  <dt><a title="Stream.remove" href="http://wiki.developers.facebook.com/index.php/Stream.remove">stream.remove</a>
    <font color="red">(BETA)</font> </dt>
  <dd>This method removes a post from a user's Wall. The post also gets
removed from the user's and the user's friends' News Feeds. Your
application may only remove posts that were created through it. </dd>
  <dt><a title="Stream.removeComment" href="http://wiki.developers.facebook.com/index.php/Stream.removeComment">stream.removeComment</a> <font color="red">(BETA)</font> </dt>
  <dd>This method removes a comment from a post. </dd>
  <dt><a title="Stream.removeLike" href="http://wiki.developers.facebook.com/index.php/Stream.removeLike">stream.removeLike</a>
    <font color="red">(BETA)</font> </dt>
  <dd>This method removes a like a user added to a post. </dd>
  <dt><a title="Users.getInfo" href="http://wiki.developers.facebook.com/index.php/Users.getInfo">users.getInfo</a>
  </dt>
  <dd>Returns a wide array of user-specific information for each user
identifier passed, limited by the view of the current user. </dd>
  <dt><a title="Users.getLoggedInUser" href="http://wiki.developers.facebook.com/index.php/Users.getLoggedInUser">users.getLoggedInUser</a> </dt>
  <dd>Gets the user ID (<code>uid</code>) associated with the current
session. </dd>
  <dt><a title="Users.getStandardInfo" href="http://wiki.developers.facebook.com/index.php/Users.getStandardInfo">users.getStandardInfo</a> </dt>
  <dd>Returns an array of user-specific information for use by the
application itself. </dd>
  <dt><a title="Users.hasAppPermission" href="http://wiki.developers.facebook.com/index.php/Users.hasAppPermission">users.hasAppPermission</a> </dt>
  <dd>Checks whether the user has opted in to an extended application
permission. </dd>
  <dt><a title="Users.isAppUser" href="http://wiki.developers.facebook.com/index.php/Users.isAppUser">users.isAppUser</a>
  </dt>
  <dd>Returns whether the user (either the session user or user
specified by UID) has authorized the calling application. </dd>
  <dt><a title="Users.isVerified" href="http://wiki.developers.facebook.com/index.php/Users.isVerified">users.isVerified</a>
    <font color="red">(BETA)</font> </dt>
  <dd>Returns whether the user is a verified Facebook user. </dd>
  <dt><a title="Users.setStatus" href="http://wiki.developers.facebook.com/index.php/Users.setStatus">users.setStatus</a>
  </dt>
  <dd>Updates a user's Facebook status. </dd>
  <dt><a title="Video.getUploadLimits" href="http://wiki.developers.facebook.com/index.php/Video.getUploadLimits">video.getUploadLimits</a> <font color="red">(BETA)</font> </dt>
  <dd>Returns the file size and length limits for a video that the
current user can upload through your application. </dd>
  <dt><a title="Video.upload" href="http://wiki.developers.facebook.com/index.php/Video.upload">video.upload</a>
  </dt>
  <dd>Uploads a video owned by the current session user and returns the
video. </dd>
</dl>

<a style="font-family: Helvetica,Arial,sans-serif;" name="Batching_API"></a>
<h2 style="font-family: Helvetica,Arial,sans-serif;"><span class="mw-headline">Batching API </span></h2>

<a style="font-family: Helvetica,Arial,sans-serif;" name="Data_Store_API_BETA"></a>
<dl style="font-family: Helvetica,Arial,sans-serif;">

  <dt><a title="Video.upload" href="file:///index.php/Video.upload">batch.run</a>
  </dt>
  <dd>run multiple api calls within one call. </dd>
</dl>

<a style="font-family: Helvetica,Arial,sans-serif;" name="Batching_API"></a>
<h2 style="font-family: Helvetica,Arial,sans-serif;"><span class="mw-headline">Data Store API <font color="red">BETA</font></span></h2>

<h2 style="font-weight: normal; font-family: Helvetica,Arial,sans-serif;"><span class="mw-headline">User Preference API</span></h2>

<p style="font-family: Helvetica,Arial,sans-serif;"><b>Note:</b>
Desktop applications can call these methods. </p>

<table style="font-family: Helvetica,Arial,sans-serif;">

  <tbody>
    <tr>
      <td>* <a title="Data.setUserPreference" href="http://wiki.developers.facebook.com/index.php/Data.setUserPreference">data.setUserPreference</a> </td>
      <td>update one preference </td>
    </tr>
    <tr>
      <td>* <a title="Data.setUserPreferences" href="http://wiki.developers.facebook.com/index.php/Data.setUserPreferences">data.setUserPreferences</a> </td>
      <td>update multiple preferences in batch </td>
    </tr>
    <tr>
      <td>* <a title="Data.getUserPreference" href="http://wiki.developers.facebook.com/index.php/Data.getUserPreference">data.getUserPreference</a> </td>
      <td>get one preference of a user </td>
    </tr>
    <tr>
      <td>* <a title="Data.getUserPreferences" href="http://wiki.developers.facebook.com/index.php/Data.getUserPreferences">data.getUserPreferences</a> </td>
      <td>get all preferences of a user </td>
    </tr>
  </tbody>
</table>

<a style="font-family: Helvetica,Arial,sans-serif;" name="Object_Data_Definition_API"></a>
<h2 style="font-family: Helvetica,Arial,sans-serif;"><span class="editsection"></span><span style="font-weight: normal;" class="mw-headline">Object Data Definition API</span></h2>

<p style="font-family: Helvetica,Arial,sans-serif;"><b>Note:</b>
Desktop applications cannot call these methods. </p>

<table style="font-family: Helvetica,Arial,sans-serif;">

  <tbody>
    <tr>
      <td>* <a title="Data.createObjectType" href="http://wiki.developers.facebook.com/index.php/Data.createObjectType">data.createObjectType</a> </td>
      <td>create a new object type </td>
    </tr>
    <tr>
      <td>* <a title="Data.dropObjectType" href="http://wiki.developers.facebook.com/index.php/Data.dropObjectType">data.dropObjectType</a> </td>
      <td>delete an object type and all objects of this type </td>
    </tr>
    <tr>
      <td>* <a title="Data.renameObjectType" href="http://wiki.developers.facebook.com/index.php/Data.renameObjectType">data.renameObjectType</a> </td>
      <td>rename an object type </td>
    </tr>
    <tr>
      <td>* <a title="Data.defineObjectProperty" href="http://wiki.developers.facebook.com/index.php/Data.defineObjectProperty">data.defineObjectProperty</a>
      </td>
      <td>add a new property </td>
    </tr>
    <tr>
      <td>* <a title="Data.undefineObjectProperty" href="http://wiki.developers.facebook.com/index.php/Data.undefineObjectProperty">data.undefineObjectProperty</a>
      </td>
      <td>remove a previously defined property </td>
    </tr>
    <tr>
      <td>* <a title="Data.renameObjectProperty" href="http://wiki.developers.facebook.com/index.php/Data.renameObjectProperty">data.renameObjectProperty</a>
      </td>
      <td>rename a previously defined property </td>
    </tr>
    <tr>
      <td>* <a title="Data.getObjectTypes" href="http://wiki.developers.facebook.com/index.php/Data.getObjectTypes">data.getObjectTypes</a> </td>
      <td>get a list of all defined object types </td>
    </tr>
    <tr>
      <td>* <a title="Data.getObjectType" href="http://wiki.developers.facebook.com/index.php/Data.getObjectType">data.getObjectType</a> </td>
      <td>get detailed definition of an object type </td>
    </tr>
  </tbody>
</table>


<a style="font-family: Helvetica,Arial,sans-serif;" name="Object_Data_Access_API"></a>
<h2 style="font-family: Helvetica,Arial,sans-serif;"><span class="editsection"></span><span style="font-weight: normal;" class="mw-headline">Object Data Access API</span></h2>

<p style="font-family: Helvetica,Arial,sans-serif;"><b>Note:</b>
Desktop applications cannot call these methods. </p>

<table style="font-family: Helvetica,Arial,sans-serif;">

  <tbody>
    <tr>
      <td>* <a title="Data.createObject" href="http://wiki.developers.facebook.com/index.php/Data.createObject">data.createObject</a> </td>
      <td>create a new object </td>
    </tr>
    <tr>
      <td>* <a title="Data.updateObject" href="http://wiki.developers.facebook.com/index.php/Data.updateObject">data.updateObject</a> </td>
      <td>update an object's properties </td>
    </tr>
    <tr>
      <td>* <a title="Data.deleteObject" href="http://wiki.developers.facebook.com/index.php/Data.deleteObject">data.deleteObject</a> </td>
      <td>delete an object by its id </td>
    </tr>
    <tr>
      <td>* <a title="Data.deleteObjects" href="http://wiki.developers.facebook.com/index.php/Data.deleteObjects">data.deleteObjects</a> </td>
      <td>delete multiple objects by ids </td>
    </tr>
    <tr>
      <td>* <a title="Data.getObject" href="http://wiki.developers.facebook.com/index.php/Data.getObject">data.getObject</a>
      </td>
      <td>get an object's properties by its id </td>
    </tr>
    <tr>
      <td>* <a title="Data.getObjects" href="http://wiki.developers.facebook.com/index.php/Data.getObjects">data.getObjects</a> </td>
      <td>get properties of a list of objects by ids </td>
    </tr>
    <tr>
      <td>* <a title="Data.getObjectProperty" href="http://wiki.developers.facebook.com/index.php/Data.getObjectProperty">data.getObjectProperty</a> </td>
      <td>get an object's one property </td>
    </tr>
    <tr>
      <td>* <a title="Data.setObjectProperty" href="http://wiki.developers.facebook.com/index.php/Data.setObjectProperty">data.setObjectProperty</a> </td>
      <td>set an object's one property </td>
    </tr>
    <tr>
      <td>* <a title="Data.getHashValue" href="http://wiki.developers.facebook.com/index.php/Data.getHashValue">data.getHashValue</a> </td>
      <td>get a property value by a hash key </td>
    </tr>
    <tr>
      <td>* <a title="Data.setHashValue" href="http://wiki.developers.facebook.com/index.php/Data.setHashValue">data.setHashValue</a> </td>
      <td>set a property value by a hash key </td>
    </tr>
    <tr>
      <td>* <a title="Data.incHashValue" href="http://wiki.developers.facebook.com/index.php/Data.incHashValue">data.incHashValue</a> </td>
      <td>increment/decrement a property value by a hash key </td>
    </tr>
    <tr>
      <td>* <a title="Data.removeHashKey" href="http://wiki.developers.facebook.com/index.php/Data.removeHashKey">data.removeHashKey</a> </td>
      <td>delete an object by its hash key </td>
    </tr>
    <tr>
      <td>* <a title="Data.removeHashKeys" href="http://wiki.developers.facebook.com/index.php/Data.removeHashKeys">data.removeHashKeys</a> </td>
      <td>delete multiple objects by their hash keys </td>
    </tr>
  </tbody>
</table>


<a style="font-family: Helvetica,Arial,sans-serif;" name="Association_Data_Definition_API"></a>
<h2 style="font-family: Helvetica,Arial,sans-serif;"><span class="editsection"></span><span style="font-weight: normal;" class="mw-headline">Association Data Definition API</span></h2>

<p style="font-family: Helvetica,Arial,sans-serif;"><b>Note:</b>
Desktop applications cannot call these methods. </p>

<table style="font-family: Helvetica,Arial,sans-serif;">

  <tbody>
    <tr>
      <td>* <a title="Data.defineAssociation" href="http://wiki.developers.facebook.com/index.php/Data.defineAssociation">data.defineAssociation</a> </td>
      <td>create a new object association </td>
    </tr>
    <tr>
      <td>* <a title="Data.undefineAssociation" href="http://wiki.developers.facebook.com/index.php/Data.undefineAssociation">data.undefineAssociation</a>
      </td>
      <td>remove a previously defined association and all its data </td>
    </tr>
    <tr>
      <td>* <a title="Data.renameAssociation" href="http://wiki.developers.facebook.com/index.php/Data.renameAssociation">data.renameAssociation</a> </td>
      <td>rename a previously defined association </td>
    </tr>
    <tr>
      <td>* <a title="Data.getAssociationDefinition" href="http://wiki.developers.facebook.com/index.php/Data.getAssociationDefinition">data.getAssociationDefinition</a>
      </td>
      <td>get definition of a previously defined association </td>
    </tr>
    <tr>
      <td>* <a title="Data.getAssociationDefinitions" href="http://wiki.developers.facebook.com/index.php/Data.getAssociationDefinitions">data.getAssociationDefinitions</a>
      </td>
      <td>get definitions of all previously defined associations </td>
    </tr>
  </tbody>
</table>


<a style="font-family: Helvetica,Arial,sans-serif;" name="Association_Data_Access_API"></a>
<h2 style="font-family: Helvetica,Arial,sans-serif;"><span class="editsection"></span><span style="font-weight: normal;" class="mw-headline">Association Data Access API</span></h2>

<p style="font-family: Helvetica,Arial,sans-serif;"><b>Note:</b>
Desktop applications cannot call these methods. </p>

<table style="font-family: Helvetica,Arial,sans-serif;">

  <tbody>
    <tr>
      <td>* <a title="Data.setAssociation" href="http://wiki.developers.facebook.com/index.php/Data.setAssociation">data.setAssociation</a> </td>
      <td>create an association between two objects </td>
    </tr>
    <tr>
      <td>* <a title="Data.setAssociations" href="http://wiki.developers.facebook.com/index.php/Data.setAssociations">data.setAssociations</a> </td>
      <td>create a list of associations between pairs of objects </td>
    </tr>
    <tr>
      <td>* <a title="Data.removeAssociation" href="http://wiki.developers.facebook.com/index.php/Data.removeAssociation">data.removeAssociation</a> </td>
      <td>remove an association between two objects </td>
    </tr>
    <tr>
      <td>* <a title="Data.removeAssociations" href="http://wiki.developers.facebook.com/index.php/Data.removeAssociations">data.removeAssociations</a> </td>
      <td>remove associations between pairs of objects </td>
    </tr>
    <tr>
      <td>* <a title="Data.removeAssociatedObjects" href="http://wiki.developers.facebook.com/index.php/Data.removeAssociatedObjects">data.removeAssociatedObjects</a>
      </td>
      <td>remove all associations of an object </td>
    </tr>
    <tr>
      <td>* <a title="Data.getAssociatedObjects" href="http://wiki.developers.facebook.com/index.php/Data.getAssociatedObjects">data.getAssociatedObjects</a>
      </td>
      <td>get ids of an object's associated objects </td>
    </tr>
    <tr>
      <td>* <a title="Data.getAssociatedObjectCount" href="http://wiki.developers.facebook.com/index.php/Data.getAssociatedObjectCount">data.getAssociatedObjectCount</a>
      </td>
      <td>get count of an object's associated objects </td>
    </tr>
    <tr>
      <td>* <a title="Data.getAssociatedObjectCounts" href="http://wiki.developers.facebook.com/index.php/Data.getAssociatedObjectCounts">data.getAssociatedObjectCounts</a>
      </td>
      <td>get counts of associated objects of a list of objects. </td>
    </tr>
    <tr>
      <td>* <a title="Data.getAssociations" href="http://wiki.developers.facebook.com/index.php/Data.getAssociations">data.getAssociations</a> </td>
      <td>get all associations between two objects </td>
    </tr>
  </tbody>
</table>

<h2 style="font-family: Helvetica,Arial,sans-serif;"><span class="mw-headline">Facebook Connect API Methods</span></h2>

<p style="font-family: Helvetica,Arial,sans-serif;">You can use most
any Platform API call Facebook Connect. In addition, here are the API
methods specific to Connect: </p>

<dl style="font-family: Helvetica,Arial,sans-serif;">

  <dt><a title="Connect.getUnconnectedFriendsCount" href="http://wiki.developers.facebook.com/index.php/Connect.getUnconnectedFriendsCount">connect.getUnconnectedFriendsCount</a>
  </dt>
  <dd>This method returns the number of friends of the current user who
have accounts on your site, but have not yet connected their accounts. </dd>
  <dt><a title="Connect.registerUsers" href="http://wiki.developers.facebook.com/index.php/Connect.registerUsers">connect.registerUsers</a> </dt>
  <dd>This method is used to create an association between an external
user account and a Facebook user account. </dd>
  <dt><a title="Connect.unregisterUsers" href="http://wiki.developers.facebook.com/index.php/Connect.unregisterUsers">connect.unregisterUsers</a> </dt>
  <dd>This method allows a site to unregister a previously registered
account (using <a title="Connect.registerUsers" href="http://wiki.developers.facebook.com/index.php/Connect.registerUsers">connect.registerUsers</a>). </dd>
</dl>

<a style="font-family: Helvetica,Arial,sans-serif;" name="Permissions_API_BETA"></a>
<h2 style="font-family: Helvetica,Arial,sans-serif;"><span class="mw-headline">Permissions API <font color="red">BETA</font></span></h2>
<span style="font-family: Helvetica,Arial,sans-serif;">With the
permissions API, an application can authorize another application to
call certain </span><a style="font-family: Helvetica,Arial,sans-serif;" title="API" href="http://wiki.developers.facebook.com/index.php/API">API</a><span style="font-family: Helvetica,Arial,sans-serif;"> methods on
its behalf. The application can revoke this access whenever necessary.
At this time, the permissions API allows applications to grant others
access to these methods: </span>
<ul style="font-family: Helvetica,Arial,sans-serif;">

  <li><a title="Admin.getAppProperties" href="http://wiki.developers.facebook.com/index.php/Admin.getAppProperties">admin.getAppProperties</a> </li>
  <li><a title="Admin.getAllocation" href="http://wiki.developers.facebook.com/index.php/Admin.getAllocation">admin.getAllocation</a> </li>
  <li><a title="Admin.getMetrics" href="http://wiki.developers.facebook.com/index.php/Admin.getMetrics">admin.getMetrics</a>
  </li>
  <li><a title="Admin.getRestrictionInfo" href="http://wiki.developers.facebook.com/index.php/Admin.getRestrictionInfo">admin.getRestrictionInfo</a>
  </li>
  <li><a title="Admin.setRestrictionInfo" href="http://wiki.developers.facebook.com/index.php/Admin.setRestrictionInfo">admin.setRestrictionInfo</a>
  </li>
  <li><a title="Admin.setAppProperties" href="http://wiki.developers.facebook.com/index.php/Admin.setAppProperties">admin.setAppProperties</a> </li>
  <li><a title="Admin.banUsers" href="http://wiki.developers.facebook.com/index.php/Admin.banUsers">admin.banUsers</a>
  </li>
  <li><a title="Admin.unbanUsers" href="http://wiki.developers.facebook.com/index.php/Admin.unbanUsers">admin.unbanUsers</a>
  </li>
  <li><a title="Admin.getBannedUsers" href="http://wiki.developers.facebook.com/index.php/Admin.getBannedUsers">admin.getBannedUsers</a> </li>
</ul>

<p style="font-family: Helvetica,Arial,sans-serif;">We'll add more
methods and namespaces to this list as needed. </p>

<p style="font-family: Helvetica,Arial,sans-serif;">You can specify
which of these API methods and/or namespaces are accessible within the
application. For example, application A can choose to have application
B gather certain stats for it by giving it permission to call
admin.getMetrics on its behalf, or it can just grant B permission to
call all admin namespace methods by granting permission for <code>admin</code>.
This implies permission to call the three allowed methods. Note that: </p>

<ul style="font-family: Helvetica,Arial,sans-serif;">

  <li>Any API method that involves accessing users' data will not be
called by some other application on an application's behalf. This is
because these API methods must abide by the trust users have in the
application that they have installed, and they have not authorized the
application to transfer that trust to another application. </li>
  <li>Any methods that are too powerful or have potential of misuse
will not be allowed. For example, <a title="Admin.setAppProperties" href="http://wiki.developers.facebook.com/index.php/Admin.setAppProperties">admin.setAppProperties</a>
will never be open to the permissions API. </li>
</ul>

<p><span style="font-family: Helvetica,Arial,sans-serif;">Be aware that
the permissions API provides a unique ability to ease some work for
applications and is very powerful. So permissions should be granted to
other applications with utmost care.<br>
</span></p>

<div style="font-family: Helvetica,Arial,sans-serif;" class="printfooter">Retrieved from "<a href="http://wiki.developers.facebook.com/index.php/Creating_a_Platform_Application">http://wiki.developers.facebook.com/index.php/API</a>"
(There is much more detailed information available at this site)<br>
</div>

<p> </p>

</body></html>